<!DOCTYPE html>
<html>

  <head>
    <meta charset='utf-8' />
    <meta http-equiv="X-UA-Compatible" content="chrome=1" />
    <meta name="description" content="CAS - Single Sign-On for the Web" />
    
    
    <link rel="stylesheet" type="text/css" media="screen"
          href="../../stylesheets/v40x-stylesheet.css">
    <link rel="stylesheet" type="text/css" media="print"
          href="../../stylesheets/print.css">
    <title>CAS - Legacy Authentication</title>
    <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.10.2/jquery.min.js"></script>
    <script src="../../javascripts/URI.js"></script>
    <script src="../../javascripts/v40x-main.js"></script>
  </head>

  <body>
    <!-- HEADER -->
    <div id="header_wrap" class="outer">
        <header class="inner">
          <a id="forkme_banner" href="https://github.com/Jasig/cas">View on GitHub</a>
          <div id="project_title">
            <a class="undecorated" href="../../index.html">
              <img class="undecorated" src="../../images/cas_logo.png"/>
            </a>
          </div>
          <h2 id="project_tagline">Single Sign-On for the Web</h2>
        </header>
    </div>

    <!-- NAVBAR -->    
    <div id="navbar_wrap" class="outer">
      <header id="navbar_content" class="inner">
        <div class="navlink">
  <a href="../../index.html">Home</a>
</div>
<div class="navlink">
  <a href="https://github.com/Jasig/cas/releases">Downloads</a>
</div>
<div class="navlink">
  <a href="https://www.google.com/cse/publicurl?cx=017040929083740828958:sqr2hwvrxmg">Search</a>
</div>
<div class="navlink">
  <a href="../../Support.html">Support</a>
</div>
<div class="navlink">
  <a href="../../Mailing-Lists.html">Mailing Lists</a>
</div>
<div class="navlink">
  <a href="../../Older-Versions.html">Older Versions</a>
</div>

        </header>
    </div>

      <!-- SIDEBAR -->
      <div id="sidebar_wrap" class="outer">
        <header id="sidebar_content" class="inner">
          <span id="sidebartoc"></span>
        </header >
      </div>
      
      <!-- PAGE TABLE OF CONTENTS -->
      <div id="table_contents" class="outer">
        <header id="sidebar_content" class="inner">
          <span id="tableOfContents"></span>
        </header>
      </div>
      
      <!-- MAIN CONTENT -->
      <div id="main_content_wrap" class="outer">
        <section id="main_content" class="inner">
          <h1 id="legacy-authentication">Legacy Authentication</h1>
<p>Legacy authentication components are enabled by including the following dependencies in the Maven WAR overlay:</p>

<div class="highlight"><pre><code class="xml">    <span class="nt">&lt;dependency&gt;</span>
         <span class="nt">&lt;groupId&gt;</span>org.jasig.cas<span class="nt">&lt;/groupId&gt;</span>
         <span class="nt">&lt;artifactId&gt;</span>cas-server-support-legacy<span class="nt">&lt;/artifactId&gt;</span>
         <span class="nt">&lt;version&gt;</span>${cas.version}<span class="nt">&lt;/version&gt;</span>
    <span class="nt">&lt;/dependency&gt;</span>
</code></pre></div>

<h2 id="legacy-components">Legacy Components</h2>
<p>CAS provides the following components to accommodate different legacy authentication needs for backwards compatibility:</p>

<h3 id="legacyauthenticationhandleradapter"><code>LegacyAuthenticationHandlerAdapter</code></h3>
<p>Adapts a CAS 3.x <code>AuthenticationHandler</code> onto a CAS 4.x <code>AuthenticationHandler</code>. If the supplied legacy authentication handler supports <code>NamedAuthenticationHandler</code>, then its defined name will be used to identify the handler. Otherwise, the name of the class itself will be used.</p>

<h3 id="credentialsadapter"><code>CredentialsAdapter</code></h3>
<p>Interface to be implemented by adapters to determine how credentials need be converted over to CAS 4.</p>

<h4 id="usernamepasswordcredentialsadapter"><code>UsernamePasswordCredentialsAdapter</code></h4>
<p>Adapts and converts a CAS 4 username/password credential into a CAS 3.x username/password credential.</p>

<h3 id="sample-configuration">Sample Configuration</h3>

<div class="highlight"><pre><code class="xml"><span class="nt">&lt;bean</span> <span class="na">id=</span><span class="s">&quot;legacyAuthHandler&quot;</span>
      <span class="na">class=</span><span class="s">&quot;org.jasig.cas.authentication.LegacyAuthenticationHandlerAdapter&quot;</span>
      <span class="na">c:legacy-ref=</span><span class="s">&quot;cas3LegacyAuthenticationHandler&quot;</span>
      <span class="na">c:adapter-ref=</span><span class="s">&quot;usernamePasswordCredentialsAdapter&quot;</span> <span class="nt">/&gt;</span>
</code></pre></div>


        </section>
      </div>

    <!-- FOOTER  -->
    <div id="footer_wrap" class="outer">
      <footer class="inner">
        <p>CAS is supported by the <a href="http://www.apereo.org/">Apereo Foundation</a>.</p>
      </footer>
    </div>
  </body>
</html>
